home *** CD-ROM | disk | FTP | other *** search
/ Mac-Source 1994 July / Mac-Source_July_1994.iso / Other Langs / Tickle-4.0 (tcl) / library / help / tcl / debug / cmdtrace next >
Encoding:
Text File  |  1993-10-26  |  2.3 KB  |  51 lines  |  [TEXT/$Tcl]
  1.  
  2.  
  3.           cmdtrace level|on ?noeval? ?notruncate? ?procs? ?fileid?
  4.                Print a trace statement for all  commands  executed  at
  5.                depth of level or below (1 is the top level).  If on is
  6.                specified, all commands at any level are  traced.   The
  7.                following options are available:
  8.  
  9.                noeval
  10.                     Causes arguments to be  printed  unevaluated.   If
  11.                     noeval  is  specified,  the  arguments are printed
  12.                     before evaluation.  Otherwise,  they  are  printed
  13.                     afterwards.
  14.  
  15.                      If the command line is longer than 60 characters,
  16.                     it is truncated to 60 and a "..." is postpended to
  17.                     indicate that  there  was  more  output  than  was
  18.                     displayed.   If  an  evaluated argument contains a
  19.                     space, the entire argument will be enclosed inside
  20.                     of  braces  (`{}') to allow the reader to visually
  21.                     separate the arguments from each other.
  22.  
  23.                notruncate
  24.                     Disables the truncation of commands and  evaluated
  25.                     arguments.
  26.  
  27.                procs
  28.                     Enables the tracing of procedure calls only.  Com-
  29.                     mands  that  aren't procedure calls (i.e. calls to
  30.                     commands that  are  written  in  C,  C++  or  some
  31.                     object-compatible  language) are not traced if the
  32.                     procs option is specified.  This option is partic-
  33.                     ularly  useful  for greatly reducing the output of
  34.                     cmdtrace while debugging.
  35.  
  36.                fileid
  37.                     This is a file id as returned by the open command.
  38.                     If  specified, then the trace output will be writ-
  39.                     ten to the  file  rather  than  stdout.   A  stdio
  40.                     buffer  flush  is done after every line is written
  41.                     so that the trace may be monitored  externally  or
  42.                     provide  useful information for debugging problems
  43.                     that cause core dumps.
  44.  
  45.           cmdtrace off
  46.                Turn off all tracing.
  47.  
  48.           cmdtrace depth
  49.                Returns the current maximum trace  level,  or  zero  if
  50.                trace is disabled.
  51.